home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / standard / ldclose.z / ldclose
Encoding:
Text File  |  2002-10-03  |  2.6 KB  |  54 lines
  1. LDCLOSE(3X)                                            Last changed: 1-8-99
  2.  
  3.  
  4. NNAAMMEE
  5.      llddcclloossee, llddaacclloossee - Closes a common object file
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddiioo..hh>>
  9.      ##iinncclluuddee <<ffiilleehhddrr..hh>>
  10.      ##iinncclluuddee <<ssyymmss..hh>>
  11.      ##iinncclluuddee <<llddffccnn..hh>>
  12.  
  13.      iinntt llddcclloossee ((_l_d_p_t_r))
  14.      LLDDFFIILLEE **_l_d_p_t_r;;
  15.  
  16.      iinntt llddaacclloossee ((_l_d_p_t_r))
  17.      LLDDFFIILLEE **_l_d_p_t_r;;
  18.  
  19. IIMMPPLLEEMMEENNTTAATTIIOONN
  20.      IRIX systems (o32 ABI only)
  21.  
  22. DDEESSCCRRIIPPTTIIOONN
  23.      llddooppeenn(3X) and llddcclloossee provide uniform access to simple object files
  24.      and object files that are members of archive files.  An archive of
  25.      common object files can be processed as if it is a series of simple
  26.      common object files.
  27.  
  28.      If TTYYPPEE((_l_d_p_t_r)) does not represent an archive file, llddcclloossee closes the
  29.      file and frees the memory allocated to the LLDDFFIILLEE structure associated
  30.      with llddppttrr.  If TTYYPPEE((_l_d_p_t_r)) is the magic number for an archive file
  31.      and if archive has more files, llddcclloossee reinitializes OOFFFFSSEETT((_l_d_p_t_r)) to
  32.      the file address of the next archive member and returns FFAAIILLUURREE.  The
  33.      LLDDFFIILLEE structure is prepared for a later llddooppeenn(3X).  In all other
  34.      cases, llddcclloossee returns SSUUCCCCEESSSS.
  35.  
  36.      llddaacclloossee closes the file and frees the memory allocated to the LLDDFFIILLEE
  37.      structure associated with llddppttrr regardless of the value of
  38.      TTYYPPEE((_l_d_p_t_r))..  llddaacclloossee aallwwaayyss rreettuurrnnss SSUUCCCCEESSSS..  TThhee ffuunnccttiioonn iiss oofftteenn
  39.      uusseedd wwiitthh llddaaooppeenn..
  40.  
  41.      The program must be loaded with the object file access routine library
  42.  
  43. BBUUGGSS
  44.      Only the memory associated with the LLDDFFIILLEE structure proper is freed.
  45.      Memory allocated for subordinate structures (e.g. the symbol table)
  46.      must be freed prior to calling llddcclloossee or llddaacclloossee.
  47.  
  48. SSEEEE AALLSSOO
  49.      ffcclloossee(3S), llddooppeenn(3X)
  50.  
  51.      iinnttrroo(4), llddffccnn(4), ppaatthhss..hh(4)
  52.  
  53.      This man page is available only online.
  54.